.TH llapi_path2fid 3 "2018-11-28" "Lustre User API"
.SH NAME
llapi_path2fid \- translate a path name to a File Identifier
.SH SYNOPSIS
.nf
.B #include <lustre/lustreapi.h>
.PP
.BI "int llapi_path2fid(const char *" path ", struct lu_fid *" fid );
.fi
.SH DESCRIPTION
.PP
.BR llapi_path2fid()
stores the Lustre file identifier (FID) for the file or directory named
by
.I path
into
.IR fid .
The
.I fid
may be then be passed to other
.B llapi_
functions that expect the
.B struct lu_fid
data type.
.SH RETURN VALUES
.LP
returns 0 on success or a negative errno value on failure.
.SH ERRORS
.TP 15
.SM -EINVAL
An invalid argument was specified.
.TP
.SM -ENOTTY
.I path
does not reside on a Lustre filesystem.
.TP
.SM -ENOENT
.I path
does not exist.
.SH SEE ALSO
.BR llapi_layout_get_by_fid (3),
.BR llapi_layout (7),
.BR llapi_fid2path (3),
.BR llapi_path2parent (3),
.BR lustreapi (7)
